home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / rir135.zip / RIR.DOC < prev    next >
Text File  |  1991-10-11  |  23KB  |  525 lines
  1. RIR - Rock dIRectory
  2.  
  3.  
  4. Purpose
  5.  
  6.     Rock Directory (RIR) is a substitute command for DOS's
  7.     directory (DIR) with a multitude of additions.  The syntax
  8.     and output of RIR is virtually identical to that of DOS's
  9.     "DIR" command, making it easy to learn; but for the power
  10.     user, the output can be tailored in many ways to make it just
  11.     the way you like it.  RIR's important documentation is built
  12.     in (type RIR ?), but this text expands on that information.
  13.  
  14.  
  15. Uses
  16.  
  17.     RIR accepts the /W and /P parameters just as DOS's DIR
  18.     command does, as well as DOS 5.0's latest additions to DIR.
  19.  
  20.     RIR is of great use to those who have a large number of
  21.     compressed files.  Its automatic detection of compressed
  22.     files makes it easier to use than most methods of viewing the
  23.     contents of compressed files; it displays them along with a
  24.     directory's other files.  It also shows additional
  25.     information on other file types, such as the dimensions of
  26.     GIF image files.
  27.  
  28.     One of RIR's biggest advantages is the ability to tailor the
  29.     appearance of the directory listing (for example, making file
  30.     names appear in lower case letters), and saving your
  31.     "default" options in an environment variable, which can
  32.     automatically be set from an autoexec.bat file.
  33.  
  34.     RIR also lets you give more precise "file specifications,"
  35.     for example RIR can show all files *not* ending in ".bak", or
  36.     all files starting with an A *or* B.  It also accepts size or
  37.     date specifications; it could show all files smaller than 1K.
  38.  
  39.     If your DOS version is earlier than 5.0, then you'll also
  40.     appreciate the DOS 5.0 DIR options included in RIR. DOS 5.0
  41.     includes the following options (in addition to the old /P and
  42.     /W): /? for help, /A to show hidden and other files, /O to
  43.     sort the order of the file list, /S to show files in the
  44.     specified directory and its subdirectories, and /B to list
  45.     files without any file information.  All of these options,
  46.     along with the environment variable setting, are included in
  47.     RIR.  As magazines begin to publish tips for DOS 5's DIR,
  48.     you'll be able to use the same tips with RIR.  (I'm not sure
  49.     the /O syntax is exactly the same yet, but it's quite close).
  50.  
  51. Features
  52.  
  53.     Some of the features RIR provides that DIR does not are:
  54.  
  55.         A single key can be used to pause/restart the display,
  56.         and ESC can be used to halt the display, as with many of
  57.         the other Rock utilities.
  58.  
  59.         RIR displays the contents of compressed files, such as
  60.         ".ARC" and ".ZIP" files.
  61.  
  62.         RIR can display directory listings with two to six files
  63.         per line if desired (/2 to /6 options).
  64.  
  65.         RIR allows you to display files in lower case (/L
  66.         option), display hidden files (/H option), show times in
  67.         24-hour format (/24 option), display file attributes (/FA
  68.         option) and more, if you prefer those settings.
  69.  
  70.         RIR will display file descriptions created with Norton's
  71.         FI or 4-DOS's DESCRIBE programs.
  72.  
  73.         RIR will also list the size & palette range of ".GIF" and
  74.         ".PCX" image files.  It can optionally list the memory
  75.         required to run .EXE files (/EC option).
  76.  
  77.         RIR can display the names of erased files (works on most
  78.         non-networked disks; note that RIR cannot unerase the
  79.         files - such resurrection requires a separate program).
  80.  
  81.         RIR accepts multiple "filespecs"; for example, you can
  82.         list all files matching *.COM and *.EXE in one command.
  83.  
  84.         Files and directories can be displayed in different
  85.         colors, according to your color and file specifications.
  86.  
  87.         RIR can translate its output (although not built-in help
  88.         or all error messages) to French, for folks who speak it,
  89.         folks learning it, or folks wanting a change of pace!
  90.  
  91.     Some of the features from MS-DOS 5.0 that RIR duplicates:
  92.  
  93.         Default parameters can be set through the RIRCMD
  94.         environment variable (see below for an explanation).
  95.  
  96.         Directories can be "recursed", so that a single RIR
  97.         command can show the contents of a directory along with
  98.         the contents of all its subdirectories - you can list
  99.         every file on a disk with one command (use /S option).
  100.  
  101.         Files can be listed one per line, without additional file
  102.         information, with the /B parameter.  The full pathname of
  103.         the file is included.  This is handy for finding files
  104.         anywhere on a disk with the /S parameter or for "piping"
  105.         filenames to the input of other programs.
  106.  
  107.  
  108. Compressed Files
  109.  
  110.     The compressed file formats that RIR can decipher are:
  111.  
  112.     .AR .ARC .ARJ .DWC .LBR .LZH .LZS .MD .PKA .PAK .ZIP .ZOO
  113.  
  114.     Note that RIR does not decode self-extracting compressed
  115.     files, which end in .COM or .EXE.
  116.  
  117.  
  118. What are compressed files?
  119.  
  120.     Not everyone uses, or needs to use, compressed files.  This
  121.     section is for those who are confused by what the term
  122.     "compressed file" means.
  123.  
  124.     A compressed file is a single file created to store one or
  125.     more other files in a "compressed" format to save space.  A
  126.     special compression/decompression program is required to do
  127.     this, such as "ARC" or "PKZIP," both available from most
  128.     shareware distribution sources or bulletin board systems.
  129.  
  130.     Compression is used for several reasons; to save space with
  131.     old files that are rarely used, to fit a lot of data on
  132.     floppy disks, or to send file through telephone lines more
  133.     quickly.  You might squeeze five 100K text files into a
  134.     single 200K compressed file, store it on a floppy, and when
  135.     you need it again, decompress it into the original five
  136.     files.  Those who download files with modems usually receive
  137.     the files in a compressed form - it's faster to download
  138.     smaller files, and with some systems, time is money!
  139.  
  140.     It's often convenient to view the contents of compressed
  141.     files without actually decompressing them.  Most
  142.     decompression programs can show the contents of files
  143.     compressed in their own format, but each compression program
  144.     has its own file format.  RIR shows you the contents of many
  145.     formats of compressed files.
  146.  
  147. Syntax
  148.  
  149.     This section is rather long, and is not required reading; if
  150.     you're a new user, just skim the examples so you know RIR's
  151.     capabilities, and when you want to do those things, use this
  152.     section as a reference (or type RIR ? the same info).
  153.  
  154.     RIR [d:][path][filespec] [options] [AND/BUT NOT filespec]
  155.  
  156.     Options
  157.        /P      Pause after each screen page of display
  158.        /W      List files with up to five filenames on each line
  159.        /1 - /6 List 1 to 6 filenames on each line (default /1)
  160.        /S      List files in the specified dir and all subdirs
  161.        /FR     Traduis à le français - Translate output to French
  162.        /?      Show RIR's built-in help information
  163.        /INFO   Show information about the Rock utilities
  164.        /ORDER  Output a Rock Utilities order form
  165.  
  166.     Examples
  167.        rir             Show current dir, with compressed files
  168.        rir /p          Show current dir, pausing every screen
  169.        rir /w          Show current directory, 5 files per line
  170.        rir c:\new\*.*  Show files in the directory c:\new
  171.        rir a: /2       Show directory of A:, 2 files per line
  172.        rir ? > PRN       Send the help screens to the printer
  173.  
  174.     Control Keys
  175.        ESC     Stop the program immediately
  176.        Others  Pause the program until next key pressed
  177.  
  178.     Control Options
  179.        /O:ord   Displays files sorted in the specified order
  180.                 ord is N E S D G and/or A: Name, Ext., Size,
  181.                 Date, Group (dirs first) or Attrs (e.g. /O:NE)
  182.                 Prepend dash to reverse sort (e.g. /O:-D)
  183.        /A:att   Show only files w/ these attributes (e.g. /A:H)
  184.                 att is R H S D and/or A: Read-only, Hidden,
  185.                 System, Dir or Archive
  186.                 Prepend dash  for "not" (e.g., /A:-D)
  187.        /E       Include Erased files/dirs (not w/all disks/DOS's)
  188.        /FA      Show file attributes of all files/directories
  189.                 [RHSDA]=ReadOnly/Hidden/System/Directory/Archive
  190.        /H       Include Hidden files/directories in list
  191.        /1STnn   Show only 1st nn files/dirs (/1ST20 shows 1st 20)
  192.        /NK      No one-key pause/abort
  193.        /1K      Enable one-key pause/abort even when redirected
  194.        /I       Ignore RIRCMD environment variable (see below)
  195.        /-...    Ignore specific option, (e.g., /-NEC or /-O)
  196.  
  197.     Control Options - Size/Date Ranges
  198.        /GTnn    Show only files with nn bytes or greater (/GT800)
  199.        /LTnn    Show only files with nn bytes or less (/LT100)
  200.        /ONLY<date>  Show only files created on <date> (see below)
  201.        /BEF<date>   Show files created on or before <date>
  202.        /AFT<date>   Show files created on or after <date>
  203.  
  204.        <date> can be specified as "12-31-91" or "12/31/91" (or in
  205.        DD-MM-YY or YY-MM-DD orders if you set DOS or RIR to use a
  206.        foreign date format).
  207.  
  208.        <date> can also be given as a two-letter shorthand code
  209.        as follows:  TD=Today        YD=Yesterday    LW=Last Week
  210.                     LM=Last Month   LY=Last Year
  211.  
  212.     Date control examples
  213.        rir /aftlw            Show files modified in the last week
  214.        rir /befly            Show files from before last year
  215.        rir /on4-30-91        Show created on 4-30-91
  216.        rir /aft1-1-90 /bef12-31-90  Show show files made in 1990
  217.  
  218.     Output Options
  219.        /LJF    Left-Justify Files ("fname.ext" not "fname   ext")
  220.        /24 /12 Show times in 24- or 12-hour mode; USA default /12
  221.        /M /D /Y Show dates starting with month, day, or year
  222.        /U /L   All Upper or All Lower case files and directories
  223.        /ALF    All Lower case names for Files (not directories)
  224.        /SVS    Show Volume serial number (for DOS 4.0+ disks)
  225.        /T      Text lines only, e.g. <-- instead of <──
  226.        /EC     EXE comments; show required memory for EXE files
  227.        /JOIN   Show freespace for joined drives (for DOS's JOIN)
  228.        /B      Show just filenames with full paths, no other info
  229.        /BIOS   Use slower BIOS output instead of direct writes
  230.        /VL     Vertical lines between file columns, if 2+ columns
  231.        /CLS    Clear the screen before running RIR
  232.        /FF     Full footer, showing % disk used, % free, and more
  233.        /ASF    Show actual space files use, not reported "size"
  234.        /AST    Show actual space used in the totals at the end
  235.        /7 - /9 List 7-9 files per line, for 81+ column displays
  236.        /TT     Show Transfer Time (mins) to send files via modem
  237.        /NEC    No Expansion of Compressed files
  238.        /NC     No Comments (right half of 1-column listing)
  239.        /NFS    No File Stats at all (no time/date, size)
  240.        /NCF    No Compressed File comments (# & size of contents)
  241.        /N4D    No 4-Dos comments (ignore 4-DOS file descriptions)
  242.        /NFI    No FI comments (skip Norton FI file descriptions)
  243.        /NV /NT No Volume label or No program Title shown at top
  244.        /NH     No header at top at all (no "RIR", volume, etc.)
  245.        /NF     No footer at bottom at all (no files, free space)
  246.  
  247.      Yet More Examples!
  248.        rir not *.bak         Show all except .BAK files
  249.  
  250.  
  251.        rir *.com and *.exe   Show all .COM and .EXE files
  252.        rir *.exe but not r*  Show .EXE files not starting with R
  253.  
  254.        rir \*.bak /b /s      Find all *.BAK files on current disk
  255.        rir \ /a:a /b /s >bu  Log all files needing backup to "bu"
  256.        rir /o:-d /1st20      Show the most recent twenty files
  257.  
  258.        rir /fr /d /24        French output w/European date & time
  259.        rir /nfs /nh /nf /a-d Just files; no dirs or anything else
  260.        rir /e /h             Show all files, even hidden & erased
  261.  
  262.        rir /ljf /alf /nh     Left-justified, lowercase, no header
  263.  
  264.   
  265. Colorized Directory Listings
  266.    
  267.     RIR has the ability to list files in different colors, for
  268.     example showing all *.EXE in red.  To do this, a special
  269.     color definition file (example given below) tells what colors
  270.     to use, and the /C parameter (described below) tells RIR that
  271.     you want to use that special color file.
  272.  
  273.     Color Options
  274.        /C"file"  Color directory entries according to directions
  275.                  in "file"
  276.        /CN       Color name only, not file size, time, etc. (use
  277.                  with above /C)
  278.    
  279.     Examples
  280.        rir /C"c:\colors.rir"   Show directory using defs in
  281.                                c:\colors.rir
  282.        rir /C"d:\my.cls" /CN   Same, but only colorizing file name
  283.    
  284.     A sample color definition file is included with RIR (called
  285.     COLORS.RIR), and a smaller version is shown below:
  286.    
  287.        default file lgray
  288.        default dir  lblue
  289.        *.COM lred
  290.        *.EXE lred
  291.        *.BAK gray
  292.        *.DOC white
  293.        *.ARC lmagenta
  294.        *.ZIP lmagenta
  295.  
  296.     You can edit or create your own color definition file with
  297.     any text editor.  The lines beginning with "default file" and
  298.     "default dir" color tell RIR what colors to use if a file or
  299.     directory don't fall under any of the other file
  300.     specifications in the file (e.g., a file named "uh.oh" would
  301.     be colored light gray, because it does not fall under the
  302.     category *.com, *.pas, etc.)
  303.  
  304.     The other lines tell what colors to use for other files, for
  305.     example all *.COM files will be shown in "lred", or light red.
  306.     Possible color names include:
  307.    
  308.       Black  Red    Magenta   Blue   Green   Cyan   Brown   LGray
  309.       Gray   LRed   LMagenta  LBlue  LGreen  LCyan  Yellow  White
  310.    
  311.     Blank lines or lines beginning with a semicolon are ignored
  312.     in the color definition file.
  313.    
  314.     If you use RIR's color feature, the "environment variables"
  315.     section below will be very useful to you.  By adding a
  316.     command such as SET RIRCMD /C"C:\COLORS.RIR" into your
  317.     autoexec.bat file, RIR will use display listings in color
  318.     automatically, without your having to type in the color file
  319.     name each time you run it.
  320.  
  321.  
  322. Environment Variables
  323.    
  324.     If you use certain options a lot, save typing with the RIRCMD
  325.     environment variable to set RIR's default parameters, for
  326.     example type "SET RIRCMD /P".
  327.    
  328.     An environment variable is a piece of information you record
  329.     from the DOS command line to be used by various programs.
  330.     Each environment variable consists of a one-word name and an
  331.     associated value for the variable, generally a set of words
  332.     or symbols.  If you type "SET" from the DOS command line,
  333.     you'll see your current environment variables.  Common ones
  334.     include "prompt" and "path", usually set in an autoexec.bat
  335.     file.  Most DOS handbooks contain a more in-depth discussion
  336.     of environment variables and their typical uses.
  337.    
  338.     To set an environment variable, you type something like "SET
  339.     NAME WHATEVER VALUE", creating a variable called "NAME" with
  340.     the associated value "WHATEVER VALUE", which resides in DOS
  341.     memory until you turn your machine off.  If you type "SET"
  342.     now, DOS will list "NAME" along with any previously set
  343.     environment variables.
  344.  
  345.     How does RIR use environment variables? If you use certain
  346.     options almost always, you can save typing by setting a
  347.     variable called "RIRCMD" with the options you typically use
  348.     with RIR.  Every time you run RIR, it will first check the
  349.     RIRCMD variable to see if you set any options that you want
  350.     used every time you run RIR.
  351.    
  352.     For example, type "SET RIRCMD /P /24" from the DOS command
  353.     line to have RIR use the /P and /24 options until you turn
  354.     the system off, or add it to your autoexec.bat to set the
  355.     parameters each time you boot your system, so RIR will always
  356.     use the /P and /24 options.
  357.    
  358.  
  359. Customizing output
  360.  
  361.     If you have several sets of default options that you like to
  362.     use with RIR, here are two suggestions.  One is to have
  363.     separate batch files that run RIR with a particular set of
  364.     command-line options, for example "WDIR.BAT" might contain
  365.     the line "RIR %1 /W /P /L".  Another approach is to have
  366.     batch files that set the RIRCMD environment variable, for
  367.     example "WDIR.BAT" could similarly contain the line "SET
  368.     RIRCMD /W /P /L", so that after you run wdir once, you can
  369.     just run RIR, and it will use those parameters.
  370.  
  371.  
  372. File Attributes
  373.  
  374.     If you use the /FA parameter, each file will be followed by a
  375.     pair of bracket with attribute codes between them, such as
  376.     "[RHSDA]".  Only some of the letters will appear between
  377.     brackets for any particular file or directory.  The letters
  378.     stand for the following:
  379.  
  380.            R - Read only   H - Hidden      S - System
  381.            D - Directory   A - Archive
  382.  
  383.  
  384. Trouble-shooting
  385.  
  386.     If you have problems displaying RIR's output, or get CGA
  387.     "snow", try using the /BIOS parameter.  Some programs (like
  388.     FANSI, PC-Kwik, other TSRs, and many speech synthesizers)
  389.     require BIOS output to work properly.
  390.  
  391.     If you use joined drives under DOS 5.0, RIR may report
  392.     volume serial numbers incorrectly.  This is a bug in MS-DOS,
  393.     not in RIR; DOS's DIR command reports the serial number
  394.     incorrectly as well.
  395.  
  396.  
  397. Miscellaneous Tips
  398.  
  399.     Tip for RAM disk users: To make RIR (or any program or batch
  400.     file) run faster, copy it to your RAM disk, then put the RAM
  401.     disk's path first in your PATH environment variable.  For
  402.     example, if your RAM disk is D:, add to your autoexec.bat:
  403.  
  404.            COPY C:\ROCK\RIR.EXE D:\
  405.            PATH D:\;C:\ROCK;C:\DOS;....
  406.  
  407.     Tip for DOS 4.0+ users: To speed everything up, use DOS's
  408.     FASTOPEN program (it should be in your DOS directory).  For
  409.     example type FASTOPEN C:=100 to speed up your C: drive.  DOS
  410.     will then remember where the last 100 files it opened are
  411.     located, letting it open them faster.  Don't use FASTOPEN
  412.     with other disk caches & optimizers!
  413.  
  414.     Tip for 4DOS users: You can type DIR to run RIR!  Type "ALIAS
  415.     DIR D:\RIR" (assuming RIR is in the root directory of D:), or
  416.     add the alias to your aliases file if you have one.  If you
  417.     want to use 4DOS's built-in DIR after that, type *DIR instead
  418.     of DIR.
  419.  
  420.  
  421. Credits
  422.    
  423.     RIR's compressed file directory routines came from several
  424.     sources, including Phil Burn's PIBCAT, a public domain disk
  425.     cataloging system, and Don Williams' Fast File Find program.
  426.     And thanks to everyone who's provided so many suggestions!!
  427.  
  428.  
  429. Example - show current directory
  430.    
  431.     The arrows following the extensions in the following examples
  432.     indicate that the file is contained within the compressed
  433.     file preceding it.  In the example below, the file
  434.     "TTOOLS.ZIP" contains the files "TTOOLS.TPU", "TTOOLS.PAS",
  435.     and "READ.ME".  Note that the default directory listing is
  436.     easier to read than the listings with two or five-files per
  437.     line.  Two user-created file descriptions are listed in the
  438.     first example; creating them requires other programs.  The
  439.     other three comments, to the right of the files, were created
  440.     by RIR based on information in the file, for example the
  441.     dimensions of the "GIF" image file.  The last file listed is
  442.     an erased file, which is shown because of the /e option.
  443.    
  444.     C:\DATA>rir /svs /e
  445.     RIR-Rock dIRectory 1.15, (C) 1991 Rock    "RIR ?" for options
  446.    
  447.      Volume in drive C is Devel
  448.      Volume Serial Number is 1515-15E1
  449.      Directory of  C:*.*
  450.    
  451.     .           <DIR>     01-07-91  1:36a
  452.     ..          <DIR>     01-07-91  1:36a
  453.     BART     GIF   191529 12-15-90 10:33a 800x600 256 colors
  454.     BINOBJ   EXE    11088 08-29-88  5:00a This comment made w/FI
  455.     PRINT    TP5     2917 07-21-89 11:27a This one made w/4-DOS
  456.     FILEINFO FI       522 12-28-90  1:47a Contains 1 file comment
  457.     TPC      EXE    61926 05-02-89  5:50a
  458.     TPUMOVER EXE    32784 08-29-88  5:00a
  459.     TURBO    EXE   156321 05-02-89  5:50a
  460.     TURBO    TPL    44352 05-02-89  5:50a
  461.     TTOOLS   ZIP<╕  26752 11-01-90  8:45p 3 files in 42974 bytes
  462.     ttools   tpu─┤  34426 12-31-86  6:46p
  463.     ttools   pas─┤   7309 12-31-86  6:42p
  464.     read     me ─┘   1239 12-30-86  9:31p
  465.     ?RINT    TP4     3104 07-21-89  5:50a Erased
  466.           12 File(s)     531295 bytes
  467.                         6100992 bytes free
  468.  
  469.  
  470.     Example - show in wide mode, no header (normally 5 files/line)
  471.    
  472.     C:\DATA>rir /w /nh /jfs
  473.     .              ..             BART    GIF    TEMP     BAK
  474.     BINOBJ   EXE   FILEINFO FI    PRINT   TP5    TPC      EXE
  475.     TPUMOVER EXE   TURBO    EXE   TURBO   TPL    TTOOLS   ZIP═══
  476.     ttools   tpu──ttools   pas──read    me
  477.           11 File(s)    6100992 bytes free
  478.  
  479.  
  480. Example - single column, left-justified filenames, all lowercase,
  481.     24-hour mode, no comments, no header, no footer, no expansion
  482.     of compressed files, and no directories listed.  (First sets
  483.     the rircmd variable so won't have to retype it next time!)
  484.    
  485.     C:\DATA>set rircmd /ljf /l /24 /nc /nh /nf /nec /a-d
  486.     C:\DATA>rir
  487.     bart.gif       191529 12-15-90 10:33
  488.     binobj.exe      11088 08-29-88  5:00
  489.     print.tpf        2917 07-21-89 11:27
  490.     fileinfo.fi       522 12-28-90  1:47
  491.     tpc.exe         61926 05-02-89  5:50
  492.     tpumover.exe    32784 08-29-88  5:00
  493.     turbo.exe      156321 05-02-89  5:50
  494.     turbo.tpl       44352 05-02-89  5:50
  495.     ttools.zip      26752 11-01-90 20:45
  496.    
  497.    
  498. Example - list the five most recent files.  This example assumes
  499.     "rircmd" was as in the last example, and just adds two more
  500.     options to sort and to list the first five files.
  501.    
  502.     C:\DATA>rir /o:-d /1st5
  503.     fileinfo.fi       522 12-28-90  1:47
  504.     bart.gif       191529 12-15-90 10:33
  505.     ttools.zip      26752 11-01-90 20:45
  506.     print.tpf        2917 07-21-89 11:27
  507.     tpc.exe         61926 05-02-89  5:50
  508.  
  509.  
  510. Example - Same, but include hidden files and show the attributes.
  511.     The second file is hidden, indicated by the H at the right,
  512.     the first three have the archive bit set (meaning they
  513.     haven't been saved by a backup program since last modified),
  514.     and the last file is read-only, so it can't be erased
  515.     accidentally.  See documentation for RFA (Rock File
  516.     Attributes) for a more complete discussion of the topic.
  517.    
  518.     C:\DATA>rir /o:-d /1st5 /h /fa
  519.     fileinfo.fi       522 12-28-90  1:47 [    A]
  520.     secret.cod         12 12-18-90 14:23 [ H  A]
  521.     bart.gif       191529 12-15-90 10:33 [    A]
  522.     ttools.zip      26752 11-01-90 20:45 [     ]
  523.     print.tpf        2917 07-21-89 11:27 [R    ]
  524.  
  525.